home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ilptops.z / ilptops
Text File  |  1998-10-30  |  23KB  |  463 lines
  1.  
  2.  
  3.  
  4. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ilptops - convert a text file into a PostScript file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiillllppppttttooooppppssss [----BBBB #] [----CCCC n] [----DDDD] [----EEEE header]
  13.              [----FFFF fontlist] [----GGGG] [----HHHH] [----IIII #] [----JJJJ printer]
  14.              [----KKKK n] [----LLLL #] [----MMMM n] [----NNNN [tb][lcr]n]
  15.              [----OOOO #] [----PPPP #] [----QQQQ] [----RRRR #] [----TTTT #] [----UUUU]
  16.              [----VVVV] [----WWWW] [----XXXX] [----2222] [----aaaa] [----hhhh #] [----llll locale name]
  17.              [----mmmm map file] [----pppp bitmap size] [----wwww #] infiles
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _i_l_p_t_o_p_s converts a text file into a PostScript file for printing on an
  21.      Apple LaserWriter, or any other PostScript-compatible output device. It
  22.      supports selection of a variety of fonts at arbitrary point sizes, margin
  23.      specification, portrait and landscape page orientation, automatic page
  24.      numbering, page outlining, and multi-column printing. It is similar to
  25.      _i_l_p_t_o_p_s (1) except that it processes supplementary code set characters
  26.      according to the locale specified in the LC_CTYPE environment variables
  27.      [see LANG on environ(5)].  The ----llll options overrides LC_CTYPE. It also has
  28.      the capability to download bitmap and Type 1 fonts to printers.
  29.  
  30.      In the option descriptions below, physical dimensions described as # may
  31.      be specified as a single number with an optional fractional part, and a
  32.      required two-letter unit designator. Letter case is ignored. Possible
  33.      forms are:
  34.  
  35.             #.##bp   big point (1in=72bp)    [Courier: 120.000/Pbp cpi]
  36.             #.##cm   centimeter              [Courier: 4.233/Pcm cpi]
  37.             #.##in   inch                    [Courier: 1.667/Pin cpi]
  38.             #.##mm   millimeter (10mm=1cm)   [Courier: 42.333/Pmm cpi]
  39.             #.##pt   point (72.27pt=1in)     [Courier: 120.450/Ppt cpi]
  40.  
  41.      The bracketed values give the number of characters per inch (cpi) for a
  42.      point size of P units with the fixed-width Courier font.
  43.  
  44.      Options are parsed left to right. So, always the most recent option is
  45.      considered when there is a conflict. For example,
  46.  
  47.      iiiillllppppttttooooppppssss ----UUUU ----XXXX
  48.  
  49.      here, -X will be considered.
  50.  
  51.      The letter case is ignored in the options and the following options may
  52.      appear in any order.
  53.  
  54.      ----BBBB #### Bottom margin of #.
  55.  
  56.      ----CCCC nnnn Print _n copies of each page.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----DDDD   Use the Standard PostScript character set for text fonts. If this
  75.           option is not specified, the program will check whether the
  76.           specified font contains ISO 8859-1 (Latin-1) characters. If so, it
  77.           will use the ISO 8859-1 character set. Otherwise, it will use the
  78.           default character set for the specified font.
  79.  
  80.      ----EEEE hhhheeeeaaaaddddeeeerrrr
  81.           The header string will be used to print the gaudy header if ----GGGG
  82.           option is turned on. This flag has no effect if ----GGGG is not used.
  83.  
  84.      ----FFFF ffffoooonnnnttttlllliiiisssstttt
  85.           Comma seperated list of PostScript fontnames to be used with every
  86.           codeset. Possible values with acceptable short abbreviations (formed
  87.           from the upper-case letters in the font names) are as follows. The
  88.           following 35 typefaces are available on most of the PostScript
  89.           printers. Some old printers may support only the first 13 typefaces.
  90.  
  91.                       FFFFuuuullllllll NNNNaaaammmmeeee                      AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnn
  92.                       ___________________________________________
  93.                       Courier                        C
  94.                       Courier-Bold                   CB
  95.                       Courier-BoldOblique            CBO
  96.                       Courier-Oblique                CO
  97.                       Helvetica                      H
  98.                       Helvetica-Bold                 HB
  99.                       Helvetica-BoldOblique          HBO
  100.                       Helvetica-Oblique              HO
  101.                       Symbol                         S
  102.                       Times-Bold                     TB
  103.                       Times-BoldItalic               TBI
  104.                       Times-Italic                   TI
  105.                       Times-Roman                    T
  106.  
  107.                       AvantGarde-Book                AGB
  108.                       AvantGarde-BookOblique         AGBO
  109.                       AvantGarde-Demi                AGD
  110.                       AvantGarde-DemiOblique         AGDO
  111.                       Bookman-Demi                   BD
  112.                       Bookman-DemiItalic             BDI
  113.                       Bookman-Light                  BL
  114.                       Bookman-LightItalic            BLI
  115.                       Helvetica-Narrow               HN
  116.                       Helvetica-Narrow-Bold          HNB
  117.                       Helvetica-Narrow-BoldOblique   HNBO
  118.                       Helvetica-Narrow-Oblique       HNO
  119.                       NewCenturySchlbk-Bold          NCSB
  120.                       NewCenturySchlbk-BoldItalic    NCSBI
  121.                       NewCenturySchlbk-Italic        NCSI
  122.                       NewCenturySchlbk-Roman         NCSR
  123.                       Palatino-Bold                  PB
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                       Palatino-BoldItalic            PBI
  141.                       Palatino-Italic                PI
  142.                       Palatino-Roman                 PR
  143.                       ZapfChancery-MediumItalic      ZCMI
  144.                       ZapfDingbats                   ZD
  145.  
  146.           The user is not limited to the above 35 typefaces. If there are any
  147.           additional fonts that have been downloaded into the PostScript
  148.           printer, then they can be used by specifying them through fontname.
  149.           If the requested font is not found, then the PostScript interpreter
  150.           will substitute it with a Courier font. Alternatively, the user can
  151.           opt to download fonts to the printer if the corresponding outline
  152.           font is not available int the printer..  The fontname is as
  153.           specified by the ps2xlfd_map.* file [ see type1xfonts(1) ] and the
  154.           download flag in the ilptops_map.* file shoule be 1.
  155.  
  156.           Only the Courier fonts have fixed widths like typewriter and line
  157.           printer fonts. The others are proportionally spaced for improved
  158.           readability, and consequently, tabular material will not line up
  159.           properly with them.
  160.  
  161.      ----GGGG   Turn on page decorations. Prints Date,Time,File name and Page
  162.           number. If a header is specified with the ----EEEE option, it will
  163.           override file name.
  164.  
  165.      ----HHHH   Horizontal page orientation (landscape mode) instead of vertical
  166.           page orientation (portrait mode).
  167.  
  168.      ----IIII #### Top margin of # for initial page (for letterheads); if not
  169.           specified, it will default to the value given for the top margin by
  170.           default or by the -T# command.
  171.  
  172.      ----JJJJ pppprrrriiiinnnntttteeeerrrr
  173.           The printer on which the document ( output ) is going to be printed.
  174.           The printer has to be installed on the system. If this option is not
  175.           specified, _i_l_p_t_o_p_s assumes 8.5x11in page size and 0.35in margins.
  176.  
  177.      ----KKKK nnnn The maximum number of lines to be printed on the page. Default is 66
  178.           lines.
  179.  
  180.      ----LLLL #### Left margin of #.
  181.  
  182.      ----MMMM nnnn Multiple column output (n columns). In multiple column mode,
  183.           formfeeds cause column breaks instead of page breaks.
  184.  
  185.      ----NNNN [[[[ttttbbbb]]]][[[[llllccccrrrr]]]]nnnn
  186.           Number output pages. The number is placed by default in the center
  187.           of the top margin, but the margin can be selected explicitly by t
  188.           (top) or b (bottom), and the position of the page number can be
  189.           further specified by l (left), c (center), or r (right).  If an
  190.           initial top margin value is given with the -I# option, numbering
  191.           will be omitted on the first page if it is at the top. Pages are
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.           unnumbered if this option is not specified.
  207.  
  208.      ----OOOO #### Draw a # unit wide outline for pages/columns. In multi-column mode a
  209.           rectangular box is drawn around each column. A 0.4pt width outline
  210.           is an optimal choice for this option.
  211.  
  212.      ----PPPP #### Font point size. The point size also determines the interline
  213.           spacing.
  214.  
  215.      ----QQQQ   Turn on debug messages.
  216.  
  217.      ----RRRR #### Right margin of #.
  218.  
  219.      ----TTTT #### Top margin of #.
  220.  
  221.      ----UUUU   Output pages in unsorted (first to last) order instead of in sorted
  222.           (page reversed) order; some PostScript printers have page handlers
  223.           that stack the paper in this order. The default is sorted because
  224.           this is appropriate for the most common PostScript printer,the Apple
  225.           LaserWriter. Note that the newer Apple LaserWriter II series stacks
  226.           pages reversed. Therefore, the ----UUUU option should be used when sending
  227.           print jobs to a LaserWriter II printer.
  228.  
  229.      ----VVVV   Vertical page orientation (portrait mode) instead of Horizontal page
  230.           orientation (landscape mode).
  231.  
  232.      ----WWWW   Wraps long lines in the text instead of clipping them. _i_l_p_t_o_p_s reads
  233.           the character width information from fontmetric files in
  234.           /usr/lib/DPS/AFM to do the line width calculations. If the requested
  235.           font's fontmetrics file is not found, then _i_l_p_t_o_p_s ignores this
  236.           switch and defaults to clip mode. Default mode is to clip text in
  237.           long lines.
  238.  
  239.      ----XXXX   Output pages in sorted (last to first) order instead of in unsorted
  240.           (-U option) order; some printers have page handlers that stack the
  241.           paper in this order. The default is sorted because this is
  242.           appropriate for the most common PostScript printer, the Apple
  243.           LaserWriter.
  244.  
  245.      ----2222   Output PostScript file has Level 2 features.
  246.  
  247.      ----aaaa   Adjusts lines according to the rules in mmmmaaaapppp_f_i_l_e.  It has no effect
  248.           if the option -W is not used.
  249.  
  250.      ----hhhh #### Page height of #.
  251.  
  252.      ----llll llllooooccccaaaalllleeee____nnnnaaaammmmeeee
  253.           Locale name. Default is the environment variable LANG.
  254.  
  255.      ----mmmm mmmmaaaapppp____ffffiiiilllleeee
  256.           Default is /usr/lib/print/ilptops_map.<locale>.  Various locales
  257.           require their own map files. The map file includes font names,
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.           download, AFM flag and rules in the following format.  Any line that
  273.           begins with a '#' is a comment. Columns are separated from by any
  274.           sequence of spaces or tabs.
  275.  
  276.           The first non-comment lines describe the fonts and character sets
  277.           used in the document.  These lines have 5 columns: _f_o_n_t__n_a_m_e ,
  278.           _e_n_c_o_d_i_n_g , _s_c_r_e_e_n_w_i_d_t_h , _d_o_w_n_l_o_a_d__f_l_a_g and _A_F_M__f_l_a_g. Each line
  279.           describes a font and corresponding code set available for text in
  280.           the current document.
  281.  
  282.           _f_o_n_t__n_a_m_e can be the font name of either a PostScript printer font
  283.           or IRIX Font Manager font.
  284.  
  285.           _e_n_c_o_d_i_n_g is the name of the character set encoding as given in the
  286.           ps2xlfd map file(s) for the desired language in /usr/lib/X11/fonts.
  287.  
  288.           _s_c_r_e_e_n_w_i_d_t_h indicates the number of ASCII spaces that equal the
  289.           width of the font's glyphs.
  290.  
  291.           _d_o_w_n_l_o_a_d__f_l_a_g indicates whether ilptops should download the font to
  292.           the printer.  With a value 1, the program generates Type 3 fonts in
  293.           the output PostScript file.  It optimizes the amount of data sent to
  294.           the printer by generating only the font glyphs that are required for
  295.           printing the input text file. With a value 2, it simply copies Type
  296.           1 fonts to the PostScript file.  A value of 0 switches the flag off.
  297.  
  298.           _A_F_M__f_l_a_g indicates whether ilptops should use AFM to calculate
  299.           character width or not.
  300.  
  301.           After the last font descriptor line, there must be a blank line.
  302.           Comment lines are not considered to be blank lines.  After the blank
  303.           line, a single 2 column line describes the character sizes and space
  304.           between them:  _b_i_t_m_a_p__s_i_z_e indicates the preferred size of bitmap
  305.           used when generating the Type 3 font to be downloaded to the printer
  306.           and _s_i_d_e__b_e_a_r_i_n_g_s is any space that would be left around each
  307.           character generated in the Type 3 font.  They have no effect if
  308.           _d_o_w_n_l_o_a_d__f_l_a_g is off.
  309.  
  310.           The next three lines present rules which are used to adjust wrapped
  311.           lines. They contain lists lf characters that may and may not be
  312.           place at the end and beginning of lines of text.  If the following
  313.           condition is satisfied, the line will be wrapped after the current
  314.           character:
  315.  
  316.               {current character is in line 6} or
  317.               {{current character is not in line 7} and
  318.                {next character is not is line 8}}
  319.  
  320.           It has no effect if the option ----aaaa is not used.
  321.  
  322.           An example ilptops_map.ja_JP.SJIS file for the Japanese locale would
  323.           be as follows.  (Note that the line break characters are not given
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  335.  
  336.  
  337.  
  338.           since this man page might be viewed in a locale that does not
  339.           support Japanese Shift-JIS.)
  340.  
  341.  
  342.           #### ffffoooonnnnttttnnnnaaaammmmeeee           eeeennnnccccooooddddiiiinnnngggg       wwwwiiiiddddtttthhhh ddddoooowwwwnnnnllllooooaaaadddd AAAAFFFFMMMM CCCCoooouuuurrrriiiieeeerrrr
  343.           IIIISSSSOOOO8888888855559999----1111        1111     0000       1111 RRRRyyyyuuuummmmiiiinnnn----LLLLiiiigggghhhhtttt----HHHH
  344.           jjjjiiiissssxxxx0000222200008888....1111999988883333----0000  2222     1111       0000 RRRRyyyyuuuummmmiiiinnnn----LLLLiiiigggghhhhtttt....HHHHaaaannnnkkkkaaaakkkkuuuu
  345.           jjjjiiiissssxxxx0000222200001111....1111999977776666----0000  1111     1111       0000
  346.  
  347.  
  348.           #### ffffoooonnnntttt____ssssiiiizzzzeeee      ssssiiiiddddeeee____bbbbeeeeaaaarrrriiiinnnnggggssss
  349.             22224444             2222
  350.  
  351.           #### ccccaaaannnn wwwwrrrraaaapppp lllliiiinnnneeee aaaafffftttteeeerrrr tttthhhheeeesssseeee cccchhhhaaaarrrraaaacccctttteeeerrrrssss
  352.              ((((lllliiiisssstttt ooooffff SSSSJJJJIIIISSSS lllliiiinnnneeee bbbbrrrreeeeaaaakkkk cccchhhhaaaarrrraaaacccctttteeeerrrrssss))))
  353.  
  354.           #### ccccaaaannnn nnnnooootttt wwwwrrrraaaapppp lllliiiinnnneeee aaaafffftttteeeerrrr tttthhhheeeesssseeee cccchhhhaaaarrrraaaacccctttteeeerrrrssss
  355.              ((((lllliiiisssstttt ooooffff SSSSJJJJIIIISSSS lllliiiinnnneeee bbbbrrrreeeeaaaakkkk cccchhhhaaaarrrraaaacccctttteeeerrrrssss))))
  356.  
  357.           #### ccccaaaannnn nnnnooootttt wwwwrrrraaaapppp lllliiiinnnneeee bbbbeeeeffffoooorrrreeee tttthhhheeeesssseeee cccchhhhaaaarrrraaaacccctttteeeerrrrssss
  358.              ((((lllliiiisssstttt ooooffff SSSSJJJJIIIISSSS lllliiiinnnneeee bbbbrrrreeeeaaaakkkk cccchhhhaaaarrrraaaacccctttteeeerrrrssss))))
  359.  
  360.  
  361.           TTTThhhheeee RRRRyyyyuuuummmmiiiinnnn----LLLLiiiigggghhhhtttt----HHHH aaaannnndddd RRRRyyyyuuuummmmiiiinnnn----LLLLiiiigggghhhhtttt....HHHHaaaannnnkkkkaaaakkkkuuuu ffffoooonnnnttttssss iiiinnnn tttthhhheeee aaaabbbboooovvvveeee mmmmaaaapppp
  362.           ffffiiiilllleeee eeeexxxxaaaammmmpppplllleeee aaaarrrreeee ddddeeeessssccccrrrriiiibbbbeeeedddd iiiinnnn
  363.           ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////ffffoooonnnnttttssss////ppppssss2222xxxxllllffffdddd____mmmmaaaapppp....jjjjaaaappppaaaannnneeeesssseeee....  OOOOtttthhhheeeerrrr ffffoooonnnnttttssss ggggiiiivvvveeeennnn iiiinnnn tttthhhhiiiissss
  364.           ffffiiiilllleeee ccccoooouuuulllldddd bbbbeeee ssssuuuubbbbssssttttiiiittttuuuueeeedddd ffffoooorrrr tttthhhheeee RRRRyyyyuuuummmmiiiinnnn ffffoooonnnnttttssss iiiinnnn tttthhhheeee mmmmaaaapppp ffffiiiilllleeee....
  365.  
  366.      ----pppp nnnn Bitmap size used for generating Type 3 fonts. It has no effect if
  367.           _d_o_w_n_l_o_a_d__f_l_a_g is off.
  368.  
  369.      ----wwww #### Page width of #.
  370.  
  371.      DDDDeeeeffffaaaauuuullllttttssss aaaarrrreeee::::
  372.  
  373.           _i_l_p_t_o_p_s -B0.35in -C1 -FCourier -K66 -L0.35in -M1 -R0.35in -T0.35in
  374.           -X -h11.0in -w8.0in
  375.  
  376. BBBBUUUUGGGGSSSS
  377.      Currently, _i_l_p_t_o_p_s is not able to handle files that generate more than
  378.      1024 total pages.
  379.  
  380. FFFFIIIILLLLEEEESSSS
  381.      /usr/lib/print/ilptops
  382.                            filter to convert text to PostScript.
  383.  
  384.      /usr/lib/print/ilptops_map.<locale>
  385.                            Locale dependent map files.
  386.  
  387.      /usr/lib/X11/fonts/ps2xlfd_map.*
  388.                            Correlates PostScript and X11 font names.
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))                      PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss                      IIIILLLLPPPPTTTTOOOOPPPPSSSS((((1111))))
  401.  
  402.  
  403.  
  404. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  405.      lp(1)
  406.      lptops(1)
  407.      type1xfonts(1)
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.